home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-01 / 48asmdbg.zip / 48ASMDBG.DOC next >
Text File  |  1992-04-09  |  3KB  |  74 lines

  1. Date: Sat 15 Dec 90 15:51:00
  2. From: Apm279l@vaxc.cc.monash.edu.au
  3. To:   All - part 1
  4. Subj: SATURN ASSEMBLY LANGUAGE DEBUG
  5.  
  6.  * Moved from HPHH area, 1:115/678.0, on 18 Dec 90 at 05:57
  7.  
  8. From: apm279l@vaxc.cc.monash.edu.au
  9.  
  10. This is part 1 of 5. -- cut here --
  11. The following is my "sim1" package. It is for debugging your saturn code
  12. before entry to your 28/48. I use the SASS assembler, so I've only run
  13. SASS-format code through it. It is possible there are a few bugs lurking
  14. around, so don't automatically assume a problem results from something in your
  15. code. Carry is set/cleared according to my understanding of what happens
  16. on the calculator (and correspondence with Alonzo). HOWEVER: it is possible
  17. some other instructions alter the carry, or that my understanding is wrong.
  18. At one stage, it was thought that gosubs alterred carry, I have been told
  19. that this is not the case, and gosubs in this code don't alter carry.
  20.  
  21. I'm sorry I don't have time to make this code cope with more general cases,
  22. but I don't yet. It will work for almost all your code though, and I've
  23. found it quite easy to patch it's output C source to allow for some other
  24. cases anyway. For example, you can make up a C routine to simulate the
  25. effect of a jump to a part of your code which accesses RAM, if you know
  26. what a typical call might do.
  27.  
  28. For more info, see the comments at the start of sim1.c
  29.  
  30. Installation:
  31.  
  32. There are 3 files in this package: SIM1.C, SIM1.H, LABELS.H
  33. I've not tar'd them as they are not too long, and this makes it easier to
  34. unpack on any machine.
  35. All you need to do is compile sim1.c, and run it. You are prompted for
  36. the input file (similar to the source you might feed into SASS), and
  37. an output file. You are then asked if you wish to step through your
  38. programme. If you answer in the affirmative, the output c source will
  39. include calls to a debugging module, and running it will be like running
  40. your code through a debugger.
  41.  
  42. Cheers, and enjoy,
  43.  
  44. Peter      apm279l@vaxc.cc.monash.edu.au
  45.  
  46.  
  47.                                        _      __
  48.                                  ,/^._/ ^\   {  \-.
  49.                            ,-/~^/         `-/~     \.
  50.                           (    THE 48 ??!!           }
  51.               ___       /  {     A MERE ABACUS     ,/
  52.           ,//| \ \    /     ~ ~^\  MENTION IT NOT! |
  53.         ,// =|H  \*\             \,-+/^\           }
  54.       ,// = =|  P  \ \                  `-.     _,/
  55.     ,// = = =|\      \ \                   ~v/'~
  56.   ,// = = = =|  \  2   \ \
  57.  // = = = = =|    \  8   \ \
  58. ||= = = = = =|\     \  S | |
  59. ||= = = = = =|= \     \  | |
  60. ||= = = = = =|= = \     \| |
  61. ||= = = = = =|= = = \    | /
  62. ||= = = = = =|= = = = \  ||
  63. ||= = = = = =|= = = = = \||
  64. ||= = = = = =|= = = = = =||
  65. ||= = = = = =|= = = = = =||
  66. ||= = = = =,/ \ = = = = =||
  67. ||= = = =,/     \ = = = =||
  68. ||= = =,/         \ = = =||
  69. ||= =,/             \ = =||
  70. ||=,/                 \ =||
  71. \|/                     \||
  72.  
  73.  
  74.